-------------------------------------------------------------------
Enhanced Character Edit (ECE)
By ECE team
ver. 1.4
-------------------------------------------------------------------

-------------------------------------------------------------------
 Description
-------------------------------------------------------------------
This mod adds some new sliders, head parts, one race, and more natural makeup colors.

===============================================================
ECE1.4 face data is compatible with ones in 1.x.
ECE1.0+ is quite different from the older ones. 
It is changed completely because of adding a extra slider system.
Make sure to read this read me file.
There are some important points you have to notice.
===============================================================

-------------------------------------------------------------------
Main Feature
-------------------------------------------------------------------
======================================
Adds Sliders
======================================
This mod adds more than 40 extra sliders (without beast race).
It can be 1.5 times wider slider included existing one.

[Body]		[Face]		[Eye]			[Nose]	 			 
Slot Load	ForeHead Down	Eyes Height		Nose Forward	 			
Name Loading	Face Width	Eye Rotate		Nosebridge Width	 			
Head Size	Neck Width	Iris Height		Nose Tip Slope				
Neck Up/Down*	Face Length	Eyelash Length		Nostril Size				
ShoulderScale	Face Forward	Upper Eyelid Height	Nose Sellion Width				
Hand Size	Face Depth	Upper Eyelid Shape	Nose Sellion Depth				
Leg Size	Cheek Width	Lower Eyelid Height	Nose Sellion Height				
BreastScale**	Cheek Roundness	Lower Eyelid Shape	Nose Bridge Depth				
ButtScale***	Chin Jutting	Eye Size		Nose Region Convex				
Height		Chin Depth	Iris Place		[RaceTrait]				
QuiverScale	[Mouth]		Iris Size		[EyeBrows]				
WaistScale*	Mouth Size	EyeWhole Height		Eyebrow Slope				
WeaponScale	Upper Lip Size	Eyebags Scale		Eyebrow Arching				
[Head]		Lower Lip Size	[Ears]			Eyebrow	Thickness				
Femalize	Lip Tilt Up	Ear Size					
Face Roundness	Dimple Depth	Ear Shape					
Age		Lip Pouting	Elf Ear					
		Mouth Width	Ear Height	


*NeckDown and WaistScale sliders are required custom skeleton which is included in this mod. Please select the option in the installer.
**BreastScale slider is required BBP meshes and skeleton.
***ButtScale slider is required TBBP meshes and skeleton.(Unsupported current TBBP mesh)

======================================
Adds Color Sliders
======================================
Extends skin, hair, war-paint and tint colors.
You can select a color from the slider, such as transparency, brightness, hue and brightness.

======================================
Expression Sliders
======================================
It can be changed the facial expression.
Combat- and -mood can be reset by the mfg reset in console or run the Showracemenu.
Other facial expression slider not reset the same as other modelling slider.

======================================
Adds Zoom and Light
======================================
Zoom on the shift key.
It can be switched among five levels of light switching to Ctrl key such as white, yellow, bright white, bright yellow and off.


======================================
Can be changed FOV and camera direction
======================================
Hold shift key + mouse wheel, and change FOV.
Hold shift key + mouse move, and change camera direction.

======================================
Save/Load slot
======================================
You can save in the slot when you exit the showracemenu. Saved-slot can be called from the Slot Load slider.


======================================
Vertex Edit
======================================
It can be adjusted to a vertex position. It supports human mesh of vanilla.
I recommend using a mouse.
When you select Vertex Edit category, show a UV map on the lower center, so you can choose a vertex.
You can scale the map on the mouse wheel. 
You can tweak a selected vertex by dragging crossed arrow or moving xyz sliders.
If you want to stop the player's animation, type "player.sae idlestaticposeastart" in console. I recommend making a batch file.
Mirror edit mode(x symmetrical) is default. It can be toggle in the slider.

When you move a vertex, you can edit range to be moved at same time apex of that around.
The type of interpolation can be specified following mode.
 - cubic interpolation (smooth mountain-shaped)
 - line interpolation (pyramid )
 - flat interpolation (same movement in range)

Stop Animation Slider is stopped animation of standing. 

Vertex does not confirm edit until you change a selected vertex.
If you want to edit the same vertex, you will need to be re-selected ones.


======================================
Undo/Redo Panel 
======================================
Revision history listed on the left side, you can undo/redo freely by clicking.
Undo is recordable up to 50 times.
You can scroll through the history with the mouse wheel.
You can also move one at a time with PageUp / Down on the keyboard.
Some operations are not listed in revision history.


======================================
Modify morph files
======================================
- Adds and improves head parts.
This mod adds more than 30 extra parts of eyes, nose and lips.
And it improves almost vanilla parts for get easier to create a character.
- Fixed asymmetry mesh.
- Human female cheeks are rounded. 
- Adds human head parts of elves and orc race.
- Numeric display for all sliders

======================================
Additional Race YgNord
======================================

Note
::::::::::::::::::::::::::::::::::::::
This race uses a different folder in both textures and meshes.
You need to manually put the correct files from body and/or face mod in those folders.

Textures\Actors\character\Enhanced\female
Meshes\actors\character\ygNord
::::::::::::::::::::::::::::::::::::::

YgNord's status and ability are same as Nord.
YgNord's female more rounded cheeks and lower nose.
YgNord's male is the default face. Recommended use a female slider, because hair may be buried under face.

Includes "Race Compatibility" and "Race Compatibility improved" for additional race bug fixed.


======================================
Other Features
======================================
These features cannot use when you select "incompatible package" in installer, alternatively it does not conflict with mod which edit race record (such as SkyRe race)..

- Adds 11 eyebrows to female, five eyebrows to male.
- Adds 40+ tint colors.
- Adds 20+ hair colors.
- Adds six moles, one freckles to female.


--------------------------------------------------------------------------
Requirement
--------------------------------------------------------------------------

SKSE 1.6.9+
Skyrim 1.9.32
More old versions of them won't work at all.

-------------------------------------------------------------------
 Installation
-------------------------------------------------------------------

Common tasks:
1) Install SKSE. http://skse.silverlock.org/
@It makes sure put scripts in the data folder.

Install with NMM:
1) Download from "Download with manager" button on nexus.
2) Press the "Activates the selected Mod" button.
3) Select if you need options.
4) When asked if you want to overwrite existing files, say "Yes to all". 

Install with Wrye Bash:

1) Run Wrye Bash.
2) Select the mod in the Installers tab of Wrye Bash and then drag and drop EnchancedChacterEdit.7z.
3) When asked if you want to copy or move, you chose either one.
4) Right-clicked and then select the wizard.
5) Select if you need options.
6) Check the Apply these selections and Install this package and then press the finish at the end.

Manual Install:

1) Extract the downloaded archive to a temporary location.
2) Then move it to the Skyrim "Data" folder.


In regard to optional files:


Full package: It available all the features.
No Additional Race: It not add the additional race which YgNord.
Incompatible Package: It cannot be used other features of e.g. adds eyebrows, alternatively it does not conflict with mod which edits race record (such as SkyRe race).
Skeletons: Required to use the neck and waist sliders. Please select skeleton mod which you are using.
              If not on this list, modify skeleton yourself. I explain in the Q & A "How to modify a skeleton for applying neck and waist slider".
No Cheeks fix: Disable modify to round cheeks for the human female.
No Vampire Cheek: No sunken cheeks when player is a vampire.
Slider 2x: It can be twice wider sliders.
Slider 2x and Step 2x: It can be twice wider and detailed sliders.


-------------------------------------------------------------------
 How to Upgrade
-------------------------------------------------------------------

Upgade from 1.0+ to 1.4.
Face does not collapse. But, if you modify ECE file(e.g. change ygnord body)  or install ECE modified mod, please backup file before installing.
_ECE_Backup.bat is backup support tool. Copy this file to skyrim folder\data\, and then run it.
Skyrim folder\data\_ECEBackup\ is created. There is all ECE files in data folder.


Upgrade from 0.83- to 1.0+:

If you will overwrite of "Racial Compatibility" or "Racial Compatibility for dawnguard":
The following pex files will not be used anymore, please check file size and delete it if match.
*** IF THE FILE SIZE IS DIFFERENT. IT IS PROBABLY USED BY OTHER MOD. DO NOT DELETE IT. ***
- Data/Scripts/CompanionsHouseKeepingScript.pex: If file size is 28,504 bytes, please delete it.
- Data/Scripts/PlayerVampireQuestScript.pex: If the file size of is 12,622 bytes, please delete it.
- Data/Scripts/PlayerWerewolfChangeScript.pex: If the file size of is 12,475 bytes, please delete it.

If you switch from ECE0.8x, face does not collapse except eye/nose/mouth parts.  Recovers by reselecting the parts.

-------------------------------------------------------------------
 Q & A
-------------------------------------------------------------------
When you run into trouble, please show a message or data\SKSE\plugins\CharacterMakingExtender.log.

Q. It is does not work.
A. You make sure to install SKSE.

Q. Additional slider does not appear.
A. You make sure install Data\SKSE\Plugins\CharacterMakingExtender_plugin.dll.

Q. Additional slider does not work.
A. You make sure activate the EnhancedCharacterEdit.esp and CharacterMakingExtender.esp in your mod launcher by checking its box.

Q. Skyrim crash on startup.
A. Does not match the version of SKSE plug-in and TESV.exe.
   Or you are wrong installation. Please update TESV.exe or retry to install.

Q. Skyrim crash on showracemenu or appear error dialog "target cache has not found.please retry.system is too heavy?".
A. Do you install below incompatible mod?
   Do showracemenu in a small building (Breezehome, Honeyside), never in the open space. 
   Or use the ShowRaceMenu PreCacheKiller.

Q. Neck down and waist sliders does not appear.
A. It is required skeleton that supports this feature.

- If you use the skeleton in options.
Use the installer when you choose skeletons.
YgNord and other additional race Skeleton separated.
Please copy and paste it from the options.

- How to modify the skeleton for applying neck and waist sliders.

Required: NifSkope

Open the skeleton that you want to edit in NifSkope.
Unchecked the Auto sanitized before save.
Follow the hierarchy of blocklist.
Skeleton female.nif -> NPC -> NPC Root -&gt; NPC COM -&gt; NPC Spine -&gt; NPC Spine1 -&gt; NPC Spine2 -&gt; NPC Neck -&gt; NPC Head
Click Select Node-> Attach Parent Node-> NiNode right while selecting NPC Head.
Click the icon of the Value of Name Txt where in the Block Details.
Enter "CME HeadPos" in the input field.
Hold Ctrl + down key, until set a maximum number of nodes on the Block List. (maximum number of node: about 268)
Repeat steps 3-7 for CME Spine1, CME Spine 2. (NPC -> NPC Root -&gt; NPC COM -&gt; NPC Spine -&gt; NPC Spine1 -&gt; NPC Spine2)
Save file at the end.


Q. Apply additional sliders to the additional race.

Many additional races to respond automatically.
Create a new ini file from the text in data\meshes\CharacterMakingExtender\.
Type the following.

Example:
[Race]
EDID = YgNordRace, ygNordRaceVampire
SliderIni = commonTriRaces\HumanRaces_Slider.ini
Preset = YgNordPreset1.slot

EDID has to fit exactly with (EditorID appropriate tribal Race-> open in TES5Edit or CK) name of Editor ID.

 Additional race e.g. Ashen that morph is separated unsupport.
Copy and paste textures from unsupported race folder to YgNord folder. Use the YgNord is easy.


Q. Apply face data are made by additional sliders to the NPC.

You can import to NPC face morph.
 Body sliders, hair and colors cannot be applied.

First, make a face you want to transport in showracemenu.
This is saved in NoseType32.
Load and save as Skyrim.esm in CK. (example:Lydia.esp)
Check this esp, CharacterMakingExtender.esp and hair esp(esm) If you use, active only made a esp and then load files.
Select the actor you want to change, click the Reset All button and then select NoseType32 in the Character Gen tab.
Edit hair and makeup in Chargen Parts tab. Click the OK after editing.
Your output selected the actor to mesh with Ctrl + F4. Save temporarily.
If you don't need master file to CharacterMakingExtender.esp, push the Ctrl + Delete deregistrate master in File->Data window->Parent Masters and then load and save.

-If you want to apply npc to change neck-length  and head size.

When you do not work, you do not change the neck-length and head size. Position of hair is incorrect.
Head equipment is incorrect with even when performing this task, because it changes the mesh.
You want to correct the head equipment, not in this way, please specify the Skeleton was custom made a dedicated race.
When you want to apply the length of the neck / head size, change the 33 LipType.  You know hair is incorrect in the preview. This is fixed in later, you output selected the actor to mesh with Ctrl + F4.
NifSkope is below open in meshes\actors\character\FaceGenData\FaceGeom\, the face data of NPC. (It is easy updates to the most recent date and time sort)
We enter what you choose "Hair ~" of NiTriShape, enter twice the length of the neck that you noted to Z of Translation, + 1 to the size of the head to Scale.
Right-click, Transform-&gt; Apply the NiTriShape, and then ignore the warning click "Try anyway". Hair... made to all, please save. Be displayed correctly.

Q. What is the name slider?
For Japanese user. It is necessary for entering the name in Japanese.

Q. How to change the maximum value of the slider.
A. For break through the limit even if there is risk of collapse.
If you want to double, you should select the "More sliderMax x2" in installer.
Compatible with slot saved because only the maximum value of the slider changes; however if the load on the environment that does not have to change the maximum value, it will be fixed for the maximum value of the environment.
Be careful when you want to publish/distribute.
If you set it manually, to .ini (any) in the meshes\CharacterMakingExtender\ the maximum value is multiplied by [number] if you write "[number] SliderScale =".

--------------------------------------------------------------------------
Known issues / bugs
--------------------------------------------------------------------------
 - Player re-ride horse when you load the save state on horse riding. It is in order to fix bug blown away.
 - Player is forced third-person view when you load the save state on first-person view. It is in order to fix bug of incorrect scale.

-------------------------------------------------------------------
Incompatible
-------------------------------------------------------------------
Racemenu
BFG - Better FaceGen
Vampire Face Less Sunken Cheeks Please use option - No Vampire Cheeks.


-------------------------------------------------------------------
Racemenu
-------------------------------------------------------------------
ECE incompatible with Racemenu.
If you use Racemenu, delete Data\SKSE\Chargen.dll and Script\chargen.pex. 
You must use latest files of Racemenu.


-------------------------------------------------------------------
 My other mods
-------------------------------------------------------------------
Face Light - http://skyrim.nexusmods.com/mods/13457
Pretty Face - http://skyrim.nexusmods.com/mods/7887

-------------------------------------------------------------------
 Permission
-------------------------------------------------------------------
You are not allowed to upload this file to other sites under any circumstances.
You are not allowed to convert this file to work on other games under any circumstances.
You must get permission from me before you are allowed to modify my files to improve it.
You feel free to use face data, slot data and ini file from make this mod. No need to contact me.
But you distribute tri files, because of avoiding conflicting this mod.
No need to include tri file in face mod or follower mod.

-------------------------------------------------------------------
 Credit
-------------------------------------------------------------------
tktk	- ECE author. Adds color and parts.
RAN46   - RANs CharGen Morph. Adds parts.
Expired - Racial Compatibility and Chargen Extension(Chargen.dll)
Himika  - Racial Compatibility - compatibility with other mods improved
kapaer  - CharacterMakingExtender. Adds slider.

SKSE team    - SKSE
SkyUI team    - creating Unofficial UI SDK
Bethesda Softworks

CherryHotaling    - CHSBHC - BBP - Nude and Jiggly Mod http://skyrim.nexusmods.com/mods/4888
xp32        - XP32 Maximum Skeleton -XPMS http://skyrim.nexusmods.com/mods/26800
dDefinder    - Realistic Ragdolls and Force http://skyrim.nexusmods.com/mods/601

-------------------------------------------------------------------
Special Thanks
-------------------------------------------------------------------
Althea			Translate into English.
Hakaisama 		Translate into German.
Narsilien80/Aravis7	Translate into French.


-------------------------------------------------------------------
 Change log
-------------------------------------------------------------------
(yyyy/mm/dd)
2012.03.15 0.30b - Nexus release.
2012.03.17 0.40b - Showracemenu bug fixed. YgNord face texture bug fixed. Preset replaced first with second. 
2012.03.17 0.41b - Markarth SilverBloodInn name changed from japanese to english.
2012.04.18 0.42b - RANs CharGen Morph 0.41a included.
2012.04.03 0.50b - YgNord body separated. 15 hair colours added. 6 moles, 1 freckles added.
2012.04.06 0.52b - RANs CharGen Morph 0.42a included. Deviation of the ygnord's hands and feet fixed.
2012.04.13 0.55b - RANs CharGen Morph 0.43a included. Orc/elf parts(nose21-30,eye6-8/22-28) in human race deleted. NoseType33 added.
2012.04.18 0.60b - RANs CharGen Morph 0.45a included. NoseType33, NoseType2 fixed. YgNord's eyebrow morph added. LipType32,LipType33 added.
2012.04.22 0.65b - EyesType32,33 added. EyesType2,3 fixed. Pretty Face 1.5 included. YgNord and Breton Cheeks fixed.
2012.04.27 0.70  - NoseType36,37,38 LipType34 added. NoseType33,8 fixed.
2012.05.01 0.71  - NoseType39 added. NoseType38 fixed.
2012.05.21 0.72  - Dark Brotherhood quest bug fixed. LipType2 fixed. Chin of nord shorted. Nose down exceeded.
2012.05.27 0.75  - EyesType34 added. Lacrimal caruncle fixed. Black dots under lips fixed(LipType2,9,10,15). DeleteEyeTiltPatcher bug fixed.
2012.06.07 0.76@- EyesType35 added. 12 tint Colors added. DeleteEyeTiltPatcher bug fixed.
2012.06.13 0.80@- EyesType36 added. RANs CharGen Morph 0.46a included. Mount combat bug fixed.
2012.06.13 0.81@- RANs CharGen Morph 0.47a included. Jaw depth on nose wide replaced. Preset changed.
2012.07.06 0.83@- RANs CharGen Morph 0.49a(2 lips and 3 nose added) included.
2013.01.27 0.85@- Racial Compatibility improved included. Dawnguard quest bug fixed. Nord cheeks fixed. Scars bug fixed.
2013 03.21 1.00  - This mod overhauled. slider, zoom and light added.
2013 03.23 1.01  - "Cannot call Papyrus script event." bug fixed, maybe.
2013 03.25 1.02  - Racial Compatibility improved 1.6a included.Conflicting script messages with vampirequest and companionhousekeeping bug fixed.
2013 03.26 1.03  - Fixed an included "Racial Compatibility improved 1.6a" mistake. "Alternate Start" or "new game start" do not appear slider bug fixed.
2013 03.27 1.04  - More zoom stage added. "Cannot call Papyrus script event." when use Alternate Start bug fixed.
2013 03.31 1.05  - Occasionally version error message when first boot the new game or load game bug fixed. - CTD when starting from save in state werewolf bug fixed.
2013 09.25 1.1   - Expression slider added. Ygnord male face texture added. No cheeks fix option files added. Femalize slider added. Color slider showed RGB display.
           	   Color of the face does not change in the mole and freckles. Dirty edit cleaned.
2013 10.10 1.2 - Vertex edit added. Undo/Redo panel added. Incorrect position of hair color slider in Khajiit fixed. Irremovable tooth of Orc bug fixed. FOV and camera direction can be changed. 
2014 11.22 1.3 - Added Stop animation slider to vertex edit category.  Hair slider is displayed hair name. Added left side of Femalize slider.  High-resolution UV map of vertex edit is resized to 2048x2048.  
		 Added eyewholes hight slider. Supported language Japanese and Deutsch. Added five eyebrows of male. Ygnord is separated body from vanilla. Ygnord have new body and face texture.  Improved Error message.
		 Human race female vampire applies the vampire's eyes correctly.
2014.11.24 1.3 - Fixed bug ygNord male body is not displayed without version change.
2015.01.26 1.4 - Added head file output feature. War paint can be changed to any color. When you save the slot, output parameters of skeleton in slot file. Number of slot increased from 25 to 40.  Supported French language.
		 Added nine sliders from ECEE1.42.